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To Distribution 
From? Gary Ce Dixon 
Date’ November 8, 1974 


Subject: New Library Tools? fibrary_mape Jibrary_print,s 
| fibrary_descriptor, and 
multics_libraries_ 


In another MTB, the design principles used to implement the new 
library maintenance tool's were developed, and the strategy for 
centralizing the tibrary organization information ana search 
procedures was outiined. 


This MTB describes the command interfaces for two new tools, 
Jibrary_map (tm) and tibrary_print (lpr). library map replaces 
the nsi_shorf_H format and msi_giobal_format commands by providing 
Getailed status information for all entries in the Multics System 


Libraries. library_print performs a new tibdrary maintenance 
function, that of gathering together a group of printable jiibrary 
entries (like info segments, peruse text segments, bind IJlistss 


source segments, efc) into an MSF for printing offiine. 


Tne MTB aiso describes the library descriptor command, which can 
be used to set the name of the default tibrary descriptor and to 
return information about the contents of a tidrary descriptor. 
And finaltlys a cescription of fhe multics_fibraries. tibrary 
desctiptor is inctuded. . 


These commands and the tibrary descriptor will be includes in a 
design review of the new Jiobrary tools, to be neld in the near 
future. Note that the command which replaces msl_info has not 
been completely Gesigned yets ana wili be described by a 
subs?quent MTB. | 
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Name: tibrary_map, Im 


The tibrary_ map command selects entries from a tibrary, and 
weites the status of these entries into a fite switadte for 
dprinting. The entries in the file are alphabetized by primary 
NamMmee 


A full range of status information can be incitiuded in the 
output by using the various output arguments. Besides the 
information returnea by the status command, the status can 
include object segment attributes reported by object_info_ and 
fibrary-dependent information. 


The commana uses a {ibrary aescriptor data base and search 
program to define the structure, contents, and naming conventions 
of the. liorary. Refer to the writeup for the 
fibrary_aescriptor_compiler for more information about tibrary 
descriptors. - 


When no output arguments are specified, the choice of status 
information is controlled by the library search program for the 
particular tibrary being mapped. For the Multics Offline 
Libraries (Hardcore, Ssivager, B0S, and 355), the information 
inciludess: the names on each tlibrary entry; it entry type; ifs 
Gate of modification anda path name} and (for Hardcore and 
Salvager Libraries) the id of tne system in which the entry was 
last instatied. For other Multics Libraries, the information 
inciuaes? the names on each fibrary entry; its entry types its 
dates of modification and dumping; its path name and the path 
name of a tink*s targef$; ana its current tength, oit counts, and 
ring bracketse 


Usage 


{ibrary_map -search namei~...-search_namen- 
-cti_argl-...-cti_argg- -~-outputi~-...-outputn- 


The search mnmameS, control arguments, ana output arguments 
described below appear in the command in any order. 
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is an entry name which identifies the library 
entries to be output. The Multics star convention 
may be used to identify a group of entries. If no 
Search names are specifiea, then the default 
search names specified in the library descriptor 
are used. 


may be any of the following control arguments. 


.“Search_name search name 


-snm search name 


-library lib 


~lo Lib 


is an entry name which icentifies the IJlibrary 
entries to be output. The Multics star convention 
may be used to identify a group of entries. This 
control argument must be used when search name 
begins witn a minus (+) to distinguish fhe 
Séarcsh name from a control argument. The 
-~search name control argument may be used several 
times in the Same commana to specify several 
different search names. 


lib is a name which identifies the particular 


iibrary or group of ilbraries which are to be 
Searched wnen the tibrary descriptor describes 
more than one library. The Multics = star 
convention may be used to identify a group of 
iibraries. The list of acceptable ftibrary names 
is defined by the tibrary descriptor. More than 
one -library control argument may be specified to 
iaentify several groups) of libraries. If the 


-library control argument is not specified, then 
the aefault tibrary names specifiea in the Iibrary 
aescriptor are use€d. 


-output_file file 


-~of file 


file is the path name of the output file in which 
the ftibrary map is to be generated. It may be a 
relative or absolute path name.e If it does not 
end in a suffix of »-map, then one is aSsumed. If 
the -output_file control argument is not 
specified, then the map is generated in the 
liobraryemap fille created in the working directory. 
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~nheader heading 


“ne heading 


heaging is a character string which is placea on 
the header page of the output file to identify the 
contents of the file. If the string contains 
blanks, fhen if must be enclosed in quotes. Only 
the first 120 characters of the sfring will be 
usede If the *heacer control argument is not 
specified, then a default heading is placed on the 
heading page. (See Notes below.) 


-footer footing 


-fo footing 


feating is a character string which is placed in 
the footing line of each output page to identify 
the ftibrary being mapped. If the string contains 
blanks, then it must be enclosed in quotes. Only 
the first 45 characters of the string are used. 
If the -footer control argument is not specified, 
then a default footing tine is usea. (See Notes 
below.) 


-~oarents,s -par 


=components 
-cmMmp 


specifies thaf status information should be output 
for the parent of each IJIibrary entry. For 
example, information about an archive will be 
output when one of its components matcnes a searcn 
namee Normaliy, the output inciudes status’ for 
only those tibrary entries which match a search 
NSME. 


specifies that status information shoulda be output 
for all components of tiobrary archives which are 
identified by a searcn namee Normally, the output 
incituges status for only those ftibrary entries 
which match a search names 
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-retain specifies that jiorary entries which await 
deletion from the library fas determinea by the 
library search program) should be output. 


Normally, such entries are excluaed. 


-“library_descriptor cefname 

-clds refname 
céiname is the reference name of the tibdrary 
aescriptor which describes the tibdraries to be 
searchede The aescriptor identified by the 
ceiname willl be found by using the search rules, 
which are documented in MPM Section 3.2.6 If the 
-iibrary_descriptor control argument is not 
specifiea, then fhe default flibrary descriptor is 
USEC. (See Notes below.) 


“chase requests that any links which exist between a 
{ibrary link and its eventual target be omitted 
from the output. Normaily,s these intermediate 


iinks are inctuGec. 


-check_archiveés -Cckac 
specifies that each ilbrary segment and archive 
component is to be checked to se€ee if it is an 
archive segment, or an arcnivea arcnivee If the 
-check_archive control argument is not specified, 
checking for archives will be performed at the 
option of the tibrary searcn program. 


“check characters -ckch 

specifies that each tiorary entry is to be checked 
to see if its contents is unprintable (ieee, 
contains non-ASCII characters). In addition; 
unprintable segments are checked to determine if 
They are peruse_text object segments. If the 
-check_character control argument is not 
specifiea, character checking will be performec at 
the option of the tibrary search program. 


-check_object, =-ckob 
specifies that each tJtibrary segment and archive 
component is to be checked to see if it is an 
object segment. If the -check_objJect control 
argument is not specifiledse object checking will be 
performed at tne option of the tiorary search 
program. 


c¢ Copyright 1974, Massachusetts Institute of Tecnnology 
and Honeywell Information Systems Inc. 


MTB- 133 ! { 
MULTICS LIBRARY MAINTENANCE MANUAL t tibrary_map ! 


3) 


Basher te 
11/08/74 
Page 5 


“check, -ck 
specifies that all tnere types of checking 
(archive, Character, and object) are to be 
performed. 


outputs may be any of the following output arguments. 
These arguments specify which status information 
is to be returnec for each fibrary entry wahich 
appears in the mape If no output arguments are 
specified, then default information is output for 
each tibrary entrys uncer control of the library 
search program. 


“default, -dft 
requests that the «default information for each 
library entry be output, jin addition fg output 
requesfeGc by any ofher output arguments. 


“all, -a requests tnat all available status information be 
outpute 


“names “nm requests that ali of the names on each tlibrary 
entry be output. 


-first, -ft requests that the first name on each tibrary entry 
be oufput. 


“match requests that the names on e2ach Itiorary entry 
which mafch any of the search names given in the 
tibrary_map command be output. 


“types -tp requests that the type of each library entry 


(link, segment , airectory, archive, archive 
component, multi-segment file, or msf component) 
be outpuf. 


-oarent_patns -pp 
requests) that the path name of the parent of each 
fibrary entry be output. 


“link, -1lk requests that the path name of the target of a 
{fibrary link be output. 
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~date, -dt requests that the date modified, date used, date 
entry moagifieas ano gate dumpea for each library 
entry be output. For an archive component, the 
cate entry modified corresponds to the date 
component updated. 


-date_modified, -dtftm 
requests that the date on which each tibrary entry 
was fast modified be output. 


“date_used, «dtu 
requests that the date on which each tibrary entry 
was iast used be outpute 


~date_entry_modifiled, -dtem 
requests that the date on which the entry for a 
fiprary fink, segment, directory, archive, or 
multi~segment file was fast moagified, or the Gate 
on which a tibrary archive component was last 
updated into its archive, be output. 


“Jate_dumped, -edta 
requests that the date on which a library entry 
was tast dumped onto a backup tape be output. 


-lengthns -tn 
requests that the current tength, records used, 
and bit count or msf indicator of each IJlbrary 
entry be output. The records used are included 
only when different from the current tength. 


“current_lengths «cin 
requests that the current iength of each tibrary 
entry be oufpuft. 


“recoras_uSed, -ru 
requests that the number of records occupied by 
each Itibrary entry be output. For a multi-segment 
file, the value inctudes only those records used 
by the msf directory.e Those occupied by the msf 
components are included in the map entry for each 
component. If both tne current length and recoras 
used have been requested, then the records used 
will be omitted from the output if equal to fhe 
current tength. 
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“bif_counts -bc 
requests that the bit count of each tibrary 
segments archives archive component, = and ms f 
component be outputs along with the mst indicator 
of each library multi-segment fiie. 
“acceSS:s 7~acs 
requests that the user*s access mode to each 
library entry, ang each tftibrary entry*s ring 
brackeTfs be outfpuf,. 
enode, “md requests that the user*s access mode fo eacn 


library entry be output. 


-"ing_brackets»s -rb 


-contfentsSe 


-date_compi 


-compiler_version 


-compilter_o 


Copyright 1974, 


requests that the ring brackets of each liprary 


entry be oufpuf. 


-cT 

requests that the contents of each tibrary entry 
be checked To determine whether the entry is an 
archive, an object entry (ieees an object segment 
or archive component), a peruse text objecf entry, 
or another type of unprintabte entry. For each 
object entry, the following information is output? 
date compiled or bound$3 compiler or binder 
verslon number3 compiler options; and object 
entry attributes. The compiler version number and 
printable character lengtn of each peruse text 
oojectf entry is output. An indication is output 
for each unprintable entry. (See Notes velow.) 


led, -dtc 
requests that the date compiled be output for each 


library (bound or unbound) object entry. (See 
Notes below.) 

“CV 
requests that name ana version information be 
oufput for the compiler each object entrye 


of 
(See Notes below.) 
ptionss -co 


requests that the options used when 
object entry be output. (See Notes 


compiling each 
pelow.) 
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-aoject_info, -oil 
requests that the attributes of each object entry 


be output. Attributes include: bound object 
indicator 3 ola object format indicators; 
non-stangara object format indicator; ana the 
octal value of any call timiter. (See Notes 
below.) 


“character, -ch 
requests that an indication be output for each 
(iorary entry whose contents is unprintable (ieees 
contains non-ASCII characters). (See Notes 
below.) 


-geruse_text, -pt 
requests That the compiler version number-= and 
printable character itength be output for each 
peruse text object entry. (See Notes below.) 


-gevice_id,s, -dica 
requests that the type of aevice on which the 
fibrary entry is storeda pe output. 


“copy_switch, -cs 
requests that the copy switch setting for the 
library entry be output. 


-offset requests that the offset (from the beginning of 
its containing segment) of the contents of an 
archive component be output. The offset is an 


octal word count.e 


-uniaque_Ids, -ulc 
requests that the unique identifier of the tibrary 
entry be oufput in octal. 


“error, rer | 
requests that any error which occurred white 
obtaining status be indicated py the appropriate 
error message. The message appears in the map 
entry for the parent of the library entry in which 
the error occurred. 
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“eJlevel, -lv 
requests that a level number be output for each 


licorary entry.s The level nmumoer Indicates the 
relationship between a tibrary entry anc its 
componentSe For example, the map entry for an 


archive might appear in the map at fevel 4, and 
the archive'ts components might appear at tevel 2. 
Normally, the tevel is indicated only by relative 
indentation of entry names. 


“newlines -ni 
requests that a line be skipped before writing the 
status of each tflevel 14 entry in the map. This 
line makes it easier to identify level 1 entries. 
Normally, no tines are skipped between entries. 


Nofes 


If the output file already exists, it is truncated and 
rewritten. Thus, if several ftibrary_map commanges are executea in 
the samé working directory (by the same process, or by different 
processes) without including an -output_file control argument, 
then the output of aii but the last command is overwritten. In 
such cases, the -output_file contro! argument should be specified 
to orevent the output of the ftast command from overwriting the 

oufput of prececing commanase 


If tne -neacer hKeaging control argument is specified, then 
the heading character string is centered on the neader page of 
the oufput file beneath the fines’ 

Map of the on Entries 
of the 


Tne heading character sfring should be worded with this in mind. 
For examples: 


Map of the 35 Entries 
of the 


' Standard Service System Bind Listing Library 
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If ro header control argument is specified, then a default 
heading line is constructed by concatenating the library names, 
as shown below’ 


Map of the 35u Entries 
of the 
Libraries 


Stanaard_serviceelist, unbundled. lists 
tools. lists, author_maintainedelists network.list 


If the -footer fogo0ting control argument is specified, then 
the footing line appears at the lower left corner of each output 
page (except the heacer page), along with the name({s) of the 
level i entries appearing on that page, and the page number. If 
the -footer contro! argument is omitted, then the tibdbrary names 
are concatenatec together as with the defauit heading jine,s, and 
usea as the defauit footing tine. 


In order for some output arguments to take effect, 
information in addition to simpte stafus must be available. 
Therefore, some output arguments automatically invoke certain of 
the control arguments. For exampie, the -contents output 
argunent requires that archive, character, and object checking be 
performed, and therefore invokes the -check control argument. 
Simitarty, -date_compilea, -compiler_version, -compiler_options,s 
and -object_info output options invoke the -check_object control 
arguments; and the «character and -peruse_text output arguments 
invoke the -check_charsacter control argument. The -all output 
argunent invokes the parent, -edefault, and -check control 
arguments, as well as aif of the output arguments. 


The default tibrary name(s) and search name(s) used for the 
fibrary_map commana are cefinea in the library aescriptor for the 
libraries being mapped. The tibrary descriptor command can be 
used to print these default values. In particular, the default 
values for the agefault tibrary adescriptor can be printed by 
typing the commands 


ids default library map 


Refer to the writeup on the tibrary_ descriptor command for more 
detaiis. 
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When no -llbrary_descriptor control argument. is given in the 
command, the cefaulf ftibrary gescriptor is used. The name of the 
default library aescriptor can be set. and printed with the 
tiorary_cescriptor commande The initiat default tiprary 
Gescc Lalor, describes” the Multics systes Libraries. ~ 


Examoles: 
The command - 


fF ibrary_ wap #16 into. stb peruse_texteinto **.info **.ept 
-of documentation | ‘ oS . ea ee | ue 


_ereates: the “documentation.map file in the working acirectorys 
whicn contains _@ map of the entries in. the info.* and 
_peruse_text.* dibraries which match the search names **.info or 
**#.pT. The commana 


libeary_ map ie: online.* **. sof ontine sata aft 


creates ‘the onlinesmap file which containg a map ‘ot all of the 
entries in the ontinee* tioraries. Each map entry includes the 
date dumped, as well as whatever default information was 
specifiec by the Meciaes search program. The command 


Vibrary_ map. 


creates. a map ‘in the tibrarysmap file of the working directory 
whicn contains status for those entries in the defauit library 
(or libraries) which match = the default search name(s). These 
default values are ppecdiire by. the default library descriptor 
data base. 
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Name: library _print, tpr 


Tne Jibrary_print commanc selects printable entries from a 
fibrary, and writes the contents of these entries into ae file 
sultable for c«uprinting. Printable Jibrary entries are those 
whicn contain only ASCII characters. Tne ASCII portion of peruse 
text object segments is also printabie. Thus printable entries 
can include source Segments. listings, bind files, info segments, 
peruse Text object segmentS, exec_com control segmentSs printable 
multi-segment files, efc. 


‘The entries in the print file are aipnabetized by primary 
name. Each entry is preceded by a header which Ilists the status 
of the entry. An index of all entry names appears at the end of 
the file. 


Tne command uses a tibrary aescriptor data base and search 
program to Gcefine the structure, contentsSs and naming conventions 
of the iibrary. Refer to The writeup for the 
fibrary_sescriptor_compiier for more information about tlibrary 
descriptors. 


When no output arguments are specifled, the status 
information which is included in the header of each antry iis 
controlled by the tibrary search program for the particular 
library being printed. For the Multics System Libraries, the 
information includes? the names on the Iibrary entry; its entry 
type; its date of moaification; its path names; and (for 
Harccore and Salvager Libraries) the id of the system in which 
tne entry was tltast installed. 


Vsage 


fibrary_print -search_namej,~-..e.*search_ namen- 
ectl_argl-.-..e"ctil_argn- -outputi-...-outputn- 


The search names, control arguments, and output arguments 
described below appear in the command in any order. 


1) search _namej 
is an entry name which identifies the fibrary 
entries to be output. The Muitics star convention 
may be used to iaentify a group of entries. If no 
Search names are specified,» then the defauit 
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Search names specified in the fidrary descriptor 
are usede 


may be any of the following contro! arguments. 


-Search_name search name 
“snm search name 


-library Jib 


-tb jib 


is an entry name which identifies the Jtibrary 
entries to be output. The Multics star convention 
may be used to Identify a group of entries. This 
control argument must be used when search name 
begins with a minus (=) to distingulsh the 
Search name from a control argument. The 
“search name control argument may be used several 
times in the same commana fo specify several 
different search names. 


iio is a name which identifies the particular 
ijibrary or grouc of jibraries which are to be 
Searched when the tidrary descriptor describes 


more Than one library. Tne Multtics star 
convention may be usead to identify a group of 
fibrariese The list of acceptable library names 


is defined by the tibrary descriptor. More than 
one -e-liorary control argument may be specifieo to 
identify severai groups of tibraries. If the 
-jiibrary control argument is not specified, Then 
the default jibrary names specified in the tibrary 
descriptor are used. 


-output_filie fjle 


~of file 


file is the path name of the output file in which 
the (fibrary print out is to be generateac. It may 
be a relative or absolute path name. If it does 
not end in a suffix of eprint, then one is 
assumece. If the -routput file control argument is 
not specified, then the print out is generated in 
the Itibrary.print fille created in the working 
agirectorye 
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-header heading 


“he heading 


beading is a character string which is placec on 
the header page of the output file to identify the 


contents of the file. If the string contains 
blanks, then it must be enclosed in quotese Only 
the first 120 characters of the string will be 
USEGe If the eheacer contfrot argument is not 


specified, then a default neading is placed on the 
heading page. (See Notes vdeiow.) 


-footer footing 


-fo footing 


ftoeting is a character string which Is piaced in 
the footing fine of each output page to identify 
the tibrary being printed. If the string contains 
blanks, then it must be enclosed in quotes. Oniy 
the first 45 characters of the string are used. 
If the -footer control argument is not specified, 
Then a aefault footing line is useae (See Notes 
below.) 


“parent, -par 


“components 
-cmp 


specifies that the contents of the parent of each 
Jibrary entry should be output, rather than the 
liorary entry itseltf. For example, the contents 


of an archive wild be output when one of Its 
components matches a search name. Normaily, oniy 
those fibrary entries which match a search name. 


are output. 


specifies that the contents of each component of a 
library archive which matches a search name is to 
be output individually. Normally, only matching 
components of the archive are output (or if no 
components match, the entire archive is output). 


Copyright 1974, Massachusetts Institute of Technology 


and Honeywell Information Systems Inc. 


i 


i iiorary_orint 


{ 


Page 4 


“retain 


eee VD ey AY OT eee ED AEN A HE tte Gea Cte ee 


i MT B~133 
i MULTICS LIBRARY MAINTENANCE MANUAL 
i 


specifies that library entries which await 
ageletion from the tibrary (as determinea by the 
{fibrary search program) should be output: 


Normaily, such entries are exciuded. 


-ltiorary_descriptor refname 


-lds cefname 


-chase 


cefnamée is the reference name of the tiodrary 
~ @escriptor which cescribes the Jiobraries to be 
Searchece The descriptor identified by the 


cefname will be found by using the search rules, 
which are documented in MPM Section Se25 If the 
~liobrary_descriptor control argument is not 
specifieo, then tne default fibrary descriptor is 
used. {See Notes pelow.) 


requests that any tinks which exist between a 
library link and its eventual target be omitted 
from the status information in the neader. 
Normally, these intermediate links are included. 


-cneck_archivesy -ckac 


specifies that each tlorary segment and archive 
component is to be checked to see if it is an 
archive segments or an archived archive. If the 
-check_archive control argument is not specifiea, 
checking for archives wili be performeac at the 
option of the tiobrary search program. 


-check_charactere -ckch 


specifies that each tibrary entry is to be checkea 
to see if its contents is unprintable (ieee, 
contains noneASCII characters). In addition, 
unoprintable segments are checked to determine if 
they are peruse_text obdject segments. If the 
-check_character control argument Ils not 
specifiea, character checking wil! be performed at 
the option of the tiodrary search program. 


-check_object, =ckob 


specifies that each library segment ana archive 
component iS to be checked to see if it is an 
object segment. If the echeck_object control 
argument is not specified, object checking will be 
performed at the option of the Jtiorary search 
program. 
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“checks -Ck 
specifies that all fhere ftypes of checking 
(archives Character, ang object) are to be 
performed. 


outoputi may be any of the following output arguments. 
These arguments specify which status information 
is to be returnes in the neager of each tibrary 
entry which appears in the print oute If no 
output arguments are specified, then default 
information is output for each tiborary entry, 
under control of the tibrary searcn progran. 


-default, -dft 
requests that the defauit information for each 
fibrary entry be output, jn addition to output 
requestea by any other output arguments. 


“all, -a requests that all available status information be 
output. 


“Name, =nm requests that ali of tne names on each jiorary 
entry be output. 


“first, -ft requests that the first name on each library entry 
be output. 


“natch requests that fhe names on each Iilbrary entry 
which match any of the Search names given in The 
fibrary_print command be output. 


“Type, “to requests that the type of each f{ilorary entry 


Clink, segment, directory, arcnive, archive 
component, multi-segment file, or msf component) 
be output. 


-parent_paths -pp 
requests that the path name of the parent of each 
fibrary entry be output. 


“link, -!tk requests that tne path name of the target of a 
fibrary Jink be output. 


“date, -dt requests that the date modified, date used, date 


entry mooified, and date dumped for each library 
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entry be outpute For an archive component, the 
date entry modified corresponds to the date 
component updated. 


-dJate_modifiecs -datm 


requests that the agate on which each library entry 
was last modified be output. 


“date_used, -atu 


requests that the date on which each library entry 
was last used be output. 


-aate_entry_mocifled, -atem 


requests that the date on which the entry for a 
jibrary link, segments airectory, archives or 
multiesegment file was last modified, or the date 
on which a tibrary archive component was iast 
updated into its archives be output. 


~date_dumped, -dida 


requests that the date on whicn a tilorary entry 
was last ocumped onto a backup tape be output. 


“-lengthn, -tn 


requests that fhe current tength, records used, 
ana bit count or mst indicator of each tiodrary 
entry be output. The records used are included 
only when different from the current iength. 


“current_lengthysy -cln 


requests thaf the current ftength of each Iibrary 
entry be outpute 


-recoras used, eru 


requests that the numoer of records occupied by 
each library entry be outpute For a multi-segment 
file, the value includes only those records used 
by the msf directory. Those occupied by the msf 
components are inctlucea in the header information 
for each component. If botn the current tength 
and records used have been requested, then the 
recoras usec will be omittea from the output if 
equal to tne current tength. 


“olf count, -bc 


requests that the bit count of each tibrary 
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“segment, archives archive component, and asf 
_. Component be output, along with the msf Indicator 
oo Seen erably mul A segment, alee . 


-acceSS, sacs Fags a Ue | 
requests” that the user*s access mode to each 
~ -dibrary entry, ana each tibrary entry*s ring 

- brackets be output. Mae ae eae Bae SO AS 


“node, -md 


‘requests that the user*s access mode to each 
- Ulorary entry be output. 4 


“ring. brackets, “rb 


requests that the ring brackets of each tibrary 


Sod be outputs 


‘reontents,, “ct 


ee that the contents (of each? filorary entry 


be checked to determine whether the entry is 


‘printable. Tne compiler version number and 


printable Ucharacter’ ‘length of each peruse text 
—. “object entry is output. Other entries are merely > 
ee DEGKeS for printability. (See Notes below.) 


-peruse, _texty -pt 


requests Wis ha Zeealten’” Wikis “number and 
printable character length be output for each 


| peruse’ ee. patee Dey (See Notes belowe) 


Sdevice “ids 


‘edtd. 


requests ‘that ere type of device on which the 


area entry is stored be outputs 


' Meoby switchs -cs 


eoffset 


requests that the copy switch setting for the 


‘Jiprary entry be output. 


requests that the offset (from the beginning of 
its containing segment) of the contents of an 
archive component be output. The .offset is = an 


octal word count. 


-unique_id, 


-uid 


- requests that the unique identifier of the tibrary 


entry be output in octal. 
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“error, -er 3 , 
requests that any error. which occurred «hile 
obtaining status be indicated by. the appropriate 
error messagee The mesSage appears in the neader 
information for the parent of the tibrary entry in 
which the error occurred. 


elevel, -iv , a 

‘requests that a level number be output for each 
fibrary entry. The tevel number indicates the 
relationship between a tibrary entry and its 
components. For example, the header of the entry 
‘for an archive might have the archive at level 1 
and... the archive*s components at tevel 2. 
Normatiy, the level is indicated only by retative 
indentation of entry names. 


Netes 


If the output file aireddy exists, it is truncated and 
rewritten. Thus, if several tibrary_print commands are executed 
in the same working cirectory (by the same process, or by 
agifferent processes) without including an -output_file control 
argument, then the output of ati but the tast command is 
overwrittene In such caseSs the -coutput file control argument 
should oe specified to prevent the output of the last command 
from overwriting the output of preceding commands. 


If the -heaver heading control argument is specified, then 
the heading character string is centered on the header page of 
the output file beneath the lines? 

Print Out of the on Entries 
of the 


The heading char acter string shoulc be worded with this in mina. 
For example’ 


peeing: of ee 
of the 


Standara Service System Bind Listing Library 
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If no header control argument is specified, then a default 
heading jine is constructed by concatenating the tibrary names, 


as shown belows 
Map of the 35y Entries 
of the 
Libraries 


Standard_service.list,s unbundlied.tist, 
too!ls.fist, author_maintained.~!list,s network.iist 


If the -footer footing control argument is specified, then 
the fLeoating line appears at the lower left corner of each output © 
page {excepf the headaer page), along with the name(s) of the 
Jjevel 4 entries sppearing on that pages and the page number. If 
the -footer control! argument is omitted, then the ftibrary names 
are concatenatea together as with the default heading tine, and 
used as the default footing line. ‘ 


In order for some output arguments to take effect, 
information in addition to simple status must be availabie. 
Tnerefore,s, some output arguments automatically invoke certain of 
the control arguments. For example, the -contents output 
argunent requires that archive, characters, and object checking be 
performed, and fherefore invokes the -check control argument. 
Similarly, the -peruse_text output argument invokes the 
echeck_ character control argument. The -alil output argument 
invokes the -default and -check control arguments, as well as all 
of tne output arguments. 


The default tibrary name(s) and search name(s) used for the 
library print command are definea in the fiborary descriptor for 
the libraries being printed. The tiorary_ descriptor command can 
be usec to print these default values. In particular, the 
default values for tne default library descriptor can be printed 
Dy typing the command: 


las defaults tibrary_print 


Refer fo the writeup on fhe library descriptor command for more 
cetaiis. 
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When no e-library descriptor control argument is given in the 
command, the default library aescriptor is used. The name of the 
default tibrary descriptor can be set and oprinted with the 
liorary_cescriptor commande The initial default fibrary 
Ggescriptor describes the Multics System Libraries. | 


Examples 
Tne command 


{lorary_ print -!ib info.* -ib peruse_text.info **.info **.pt 
-of documentation 


creates the documentation.print fiie in the working directory, 
whicn contains a print out of the entries in the infoe* and 
peruse_text.* tfibraries which match the search names **.info or 
**.,of. The commana 


fibrary_print -lb onlineeobject **.bind -of online -dta -dft 


creates the ontine-print file which contains a print out of all 
of the bind fites in the ontine object tioraries. Each entry 
inciudes a header with the date dumped, as well as whatever 
cefault status information was specifieac by the tibrary search 
program. The command 


library_print 


creates a print out in the fibraryeprint file of the working 
directory which contalns . the contents of those entries in the 
eefault jibrary (or Jibraries) which match the default search 
name(s). These oaéefault values are specified by the default 
iibrary descriptor data base. 
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Names: iibrary descriptor, tds 


The tibrary_descriptor command controls the use of tibrary 
descriptors by {ibrary maintenance commands, and oproviaes 
information about the contents of a tibrary descriptor. The 
commands: can orint and set the name of the Jtibrary descriptor 
which is usea by default in library maintenance commands when no 
iiorary descriptor is explicitly specified; can print fhe path 
names of the Iibrary roots which are associated with one or more 
Jibrary names; can print detailed information about one or more 
of tne iibrary roots defined by the descriptors; and it can print 
the defsulf ilbrary and search names associated with each library 
commande 


The library descriptor is a data base whicn,y, with its 
associated library Search program, cefines the structure, 
contents, and naming conventions of the tibrary. Refer to the 


writeup for the tiobrary_descriptor_compliier for more information 
apout fibrary descriptors. 


Vsage 
tibrary_cescriptor key -options- 


Tne keys and their options are acescribed in the sections which 
follow. 


Key: name 
The name key returns the name of the default tibrary 


descriptor which is currently being used. fiorary descriptor may 
be invoked as an active function when tne name key is used. 


Usage 
fibrary_dGescriptor name 
Key: set name 


The sef_name key sets the name of the default library 
cesctiptore 
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Usage 
{ficorary_cescriptor set _name refname 


1) refname is the reference name of the new default Itlibrary 
aescriptor.s The cescriptor identified by refname 
is searched for according to the search rules, 
which are documented in MPM Section 342. 


Key? path 


The path key returns the path name of the fibdrary root(s) 
whicn are identified by one or more library names. 
library_descriptor may be invoked as an active function when the 
path key iS USeG. 


Usage 
library_descriptor path tib_namel ee. tid_namegq ~ctl_argi- 
1) lib_namej is a name which identifies the particular tibrary 
or group of iibraries whose paths are to be 
returned. The Mulfics star convention may be used 
to identify a group of tibraries. 
2) cti_argd may be the following optional control argument. 


-library_ descriptor cefnanme 


-~lds cefname 
Céefname is the reference name of the ftibrary 


descriptor which defines the tiobrary roots whose 
path names are to be returned. The cescriptor 
identified by refname wiili be found by using The 
search ruleS, which are documented in MPM Section 
Sele If the «library _agescriptor control argument 
is not specified, then the default library 
cescriptor is useae 


Key: defaults 


The defautts key prints the. default liorary name(s) and 
Search name(s) associated with one or more orf the ftibrary 
maintenance commandase 
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Ysage 
fibrary_aescriptor defaults -commandi- eoe “COMmanan- 


-cti_argi- 


i) command] is the name of the tibrary maintenance command 
whose default tibrary ana search names are to be 
printed. If no command names are given, the 
default tor ali of the tibrary maintenance 
commanas will be printed. 


2) ctl larg] may be any of the optional control arguments 
aefined for the path key. 


Key? roots 


The roots key prints detailed information adout one or more 
library roots on the user*s terminal. The information inctudes 
The names on each library root, its path name, ana its type. 


Usage 


fibrary descriptor roots lIib_namej e2«-¢ lib _nameq -cti_argi- 
ees “cti_argno- 


4) tib_namej is a name which icentifles the particutar Ilibrary 
roots about which information is to be printed. 
The Multics star convention may be used to 
iaentify a group of libraries. 


2) -ctl arg] may be one of the following control arguments. 


“namey “nm specifies that ali of the names defined for the 
library root are fo be printed. Usually, only thea 
first name and names’ which match tne lib _namej 
arguments are printed. 


-library descriptor cefname 


-lds cefname 
as above. 


c Copyright 1974, Massachusetts Institute of Tecnnology 
and Honeywell Information Systems Ince (END) 


{This page intentionaliy ieft blank) 


MT B= 133 : i 
MULTICS LIBRARY MAINTENANCE MANUAL i muftics_ftibraries_ 3 
Mo hr cae oe eel 

. Data Base 

Administrative/User Ring 

41/79 8/74 


Name? multics_libraries_ 


This data base is the thbrary descriptor for tne Multics 
System Libraries. Like all tibrary descriptors, it defines the 
roots of the Multics System Libraries, the names by which Jibrary 
roots can be references in the various tibrary maintenance 
commands, and the default library names and searcn names used for 
each of the tibrary maintenance commands. 


Refer to the writeup on tibrary descriptors for a definition 
of The internal structure of this Cand other) ftibrary 
cesctiptors. Refer to tne writeup on the 
fibrary_aescriptor_compiler for tne definition of the Library 
Description Language which is used to define the contents of the 
fibrary cescriptor. 


[he Multics Libraries 


The Multics System is composed of the “logical Jibdraries™ 
listed below. Each of the tibraries iss in tfurny composea of 
several directories containing the different kinds of tibrary 
Segments (source, objects, bind Lists, infos inciude, peruse_text) 
which are storea in the libraries. A tibrary maintenance command 
can reference an entire logical tibrary by name, or one or more 
of its directories. 


Note that the logical library organization defined below 
does not map directtiy onto the physical library organization in 
the Multics Storage Systeme However, the library maintenance 


tools can reference all of the physical libraries through their 
Jogical Jibrary names. 


stanagara_library, sta 
the library which contains most user commands and 
Subroutines, ana the system support routines for these 
commands and subroutines. 


unbundled library, unb 
the tiborary which contains Honeywell programmed products and 
other unbundied software. 


toois_fiibrary, fools 
the library wnicn contains system maintenance and 
administrative commands ana subroutines. 
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installation_!ltibrary, inst 
the ilbrary which contains instaltation-maintained software. 


user_iibrary, user 
the ftibrary which contains user-maintained software. 


network_library, net 
the jibrary which contains the software (for linking the 
Multics System to the ARPA Network. 


Supervisor_library,s sup 
the fibrary which contains the supervisor (ring 0) segments 
of the Multics System. 


Salvager_ltibrary, salv 
the library which contains the Wultics Storage System 
Salvager commanags and subroutines. 


boot!toad_ltibrary, bos 
tne fibrary whicn contains the commands ana subroutines of 


the Bootload Operating Systeme 


data_net_355_library, 355 
the tibrary which contains The commancs anc subroutines of 
the Data Net 355 Operating System. 


Each of the above logical tibraries contains one or more of the 
following logical airectories. 


sources S 
the clrectory containing the source tanguage segments which 
can be transtated into the object segments of the library. 


object, o 
the oirectory containing the obdject segments produced pby 
translating the source segments of the tibrary. 


fists, { 
the airectory containing the listings produced by binding 
several object segments together into a bound segment. 


executlons x 
the airectory containing bouna ang unbound object segments 
and data bases used by users of Mulfics. These directories 
are generally inctuded in the search rules of some or ait 
userSe 
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bound_comp, bc 
the directory containing the archives which may be bound 


into bound segments. 


infoe i 
the directory containing information segments whicn can be 
printed on the user's terminal under contro! of the help 
COMMAaNGe These segments describe the commancs and 
subroutines included in the tibrary, and outline !tibrary 
problems, upcoming changes, efc.e 


peruse_texT, pt : 
the directory containing the peruse_text object segments 
which describe the commands and subroutines of the library. 
Selected portions of these segments may be oprintea on the 
user’s terminal under control of the peruse_text command. 


inciuage,s incl 
the directory containing source segments which are included 
as part of several other source Se Smenta a under the control 
of a language. transtator. 


Liocary Names 


One or more fibdraries or agirectories may de referenced in a 
library maintenance command by giving tne appropriate tibrary or 
directory name. 

e An entire tibrary can be referenced by giving one of the 
fibrary names tisted above. 

» A particutar type of cirectory can be ulemencea across ail! 
libraries by giving one of the directory names listed above. 

e A oparticuiar directory within a specific tibrary can be 
reterenced by giving a 2*component name of tne form, 
jibrary.airectory. For example, standard_Itiorary.source or 

instailation_library.info . a 

» The star convention may pe used to identify several 

libraries or directories. For example, *.Source or ** . 

» Two grouos of Iibraries can ove referenced py fhe foliowing 
names’ 


online_jiibraries, on 
Standard_Jibrary, unbunclea_library, tools_Iibrary, 
installation_library, user_liibdrary, network_library. 


c Copyright 1974, Massachusetts Institute of Technology 
and Honeywell Informatior, Systems Inc. 


§ multics_jtibraries_ 


Page 


direc 
combinations are valid. 


Some 
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offiine_libraries, 
supervisor_liorarys 


of f 


agata_net_355_jibrary. 


Not all of the Jtlibraries ltisted above contain each 
following 


Torys The 


std.source 
Staceobject 
sto.elists 
Stdeexecution 
stca.info 
std.peruse_ text 
std.inciude 


inst.source. 
inst.object 
instel lIsts 
inst.execut ion 
inst.info 
inst.peruse_text 
inst.include 


sSup.esource 
SUp.ebdOUNa_comp 
supeobject 
supeinclude 


bosesource 
boseobject 
boseinclude 


lists show 


unbesource 
undeobject 
unb.slists 
unbeexecution 
unbeinfo 
unb.peruse_texft 
unbeinctlude 


useresource 
usereobject 
userelists 
usereexecution 
usereinto 
usereperuse_text 
usereinciude 


Salv.source 
saivebounsc_comp 
Ssalveobject 
saiv.inciude 


355.source 
355.-0b0ject 


examples of ftibrary names ares 


onltine_libraries 


off.source 


Standard_library.info 


include 
USer eX 


network_lJibraryelists 


Stcde???7?? 


saltveger_librarys 


which 


Information 
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type 


fToois.source 
toolseodject 
tooiselists 
Toolseexecution 
tools.info 
toolseperuse_text 
tools. include 


net.esource 
net.object 
net.elists 
nejTeexecurion 
neteinfo 
net.eperuse_ text 
neteinciude 
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bootload_Iibrary, 


ilbrary.directory 
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Libcacy Maintenance Commang Defaults 

The table below shows fhe default library names and search 
names used by each of the tibrary maintenance commandse Commands 
which have no default values are not shown in the table. 


Compang Default Library. Name OQefault Search’ Name 
tiorary_map ontine_ltibraries ae 

{jibrary_orint info **,info 
library_cleanup online_iibraries A a a a a ee a ee 
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